Description of Keys & Commands
==============================
Note: English translation still under construction!

Command-Group "ME": Steuerung von RK
====================================

RK ist so aufgebaut, da es sich vollstndig mit Knpfen, die mit Commands
dieser Gruppe belegt sind, steuern lt. Ursprnglich besa RK keine Men-
Leiste, da man eine solche mit entsprechend angeordneten RK-Knpfen simulieren
kann.
Ein Beispiel fr eine solche Leiste befindet sich im "Manual"-Profil, das beim
ersten Programm-Start von RK angezeigt wurde (siehe dort die oberste Knopf-
Reihe). Aber selbtverstndlich kann man die mit ME-Commands versehenen Knpfe
nach belieben auf dem RK-Fenster plazieren. Der obligatorische "opt"-Knopf,
der sich in der linken, oberen Ecke eines jeden Profils befindet, ist in
Wahrheit auch nichts anderes, als ein mit einem ME-Command ausgestatteter
RK-Knopf (/ME.POP.OPTION in diesem Fall).
berhaupt sollte man sich die Knopf-Belegungen des "Manual"-Profils einmal
nher ansehen, indem man die Knpfe mit gedrcktgehaltener [Strg]-Taste
anklickt.


/ME.ABOUT .............: To open RemoteKeys Info dialog
------------------------
Example: {/ME.ABOUT}


/ME.ACTIVATE ..........: To activate RK (focus), useful for Event > Keys
------------------------
Example: {/ME.ACTIVATE}


/ME.AUTOEXECUTE .......: To execute this button when profile is selected from (systray-) popmenu
------------------------

Example: {/ME.AUTOEXECUTE}

--> Note
If "Store" profile is selected an automatic user message will be showen.
This was relized with this command which is placed in the "note" button.


/ME.BORDER.OFF ........: To switch RemoteKeys to window border off mode
/ME.BORDER.ON .........: To switch RemoteKeys to window border on mode
/ME.BORDER.SWITCH .....: To switch RemoteKeys between window border on and off mode
------------------------
The Boarder-Mode has its own description.
After first start RK is switched in BORDER.ON mode.

Example: {/ME.BORDER.OFF}


/ME.BUTTON [pr],but[,lv] To execute button <but> of opt. profile <pr>, opt. level <lv> 0/1 (not case-sensitive)
------------------------
This command can execute another button.
This can be useful after development of several small buttons which should be
connected to one big automation.
Additional it is possible to define buttons which are present in other profiles.
The parameter is not case sensitive and will not distinguish between "My Profile,
My Button" and "my profile,my button".

Example: {/ME.BUTTON store,rknet}

same as 

Example: {/ME.BUTTON store,rknet,0}

but

Example: {/ME.BUTTON store,rknet,1}

executes the 2nd level which can be normally executed with the right mouse button.

--> Note
Since v8.4 the profile-name parameter is optional. That meens if it is not set, RK
will automaticly include the current profile name. But the comma before the button
name is strongly required!

Example: {/ME.BUTTON ,rknet}

--> Beachte
Es wurde festgestellt, da ein mit dem ME.BUTTOM Command aufgerufener Knopf, der
ebenfalls einen ME.BUTTON Command beinhaltet, zu Profil-Schalt-Fehlern fhrt.
Dies kann umgangen werden, indem der Command {/ME.PROF.SWITCH no} in das Skript
integriert wird, wobei in <no> die Nummer des aktuellen Profils eingetragen werden
mu.


/ME.CALENDAR ..........: To open calendar window
------------------------
This is an information window only.
Nothing can be set, especially the system date & time of the computer will not be
changed.

Example: {/ME.CALENDAR}

--> Hinweis
Ab v.8.4.6 wird das aktuelle Datum angezeigt. Wird ein anderes Datum angeklickt,
so wird die Differenz zum aktuellem Datum in der unteren Informationszeile
ausgegeben. Desweiteren werden die Monats-Nummern (1-12) in der Combo-Box dar-
gestellt und ein Knopf zum Rcksprung auf das aktuelle Datum bereitgestellt.


/ME.CLICKHIDE.ON ......: To switch "Hide after a Button-Click" on
/ME.CLICKHIDE.OFF .....: To switch "Hide after a Button-Click" off
------------------------
Example: {/ME.CLICKHIDE.ON}


/ME.CLIP.HISTORY ......: To open the external program "Clip History"
------------------------
This program has its own description.

Example: {/ME.CLIP.HISTORY}


/ME.CLIP.MON [calc] ...: To open the Clip Monitor, optional <calc>=2 for calculator use
/ME.CLIP.MON.DEC ......: To open the Clip Monitor in Decimal Mode
/ME.CLIP.MON.HEX ......: To open the Clip Monitor in Hex Mode
------------------------

Example: {/ME.CLIP.MON}


/ME.COLOR.EDIT ........: To open the external ChangeColors program
/ME.COLOR.REFRESH .....: To load the colors.dat, useful when ChangeColors finished
------------------------
"Change Colors" has its own description.

Example: {/ME.COLOR.EDIT}


/ME.CTRL.ID ...........: To view requester ID ..
/ME.CTRL.REFRESH ......: To refresh language changes
------------------------
This command is useful only for developers of RK translations into other
languages.
"Edit Language" has its own desctiption.


/ME.EVENT.KEYS ........: To open Event > Key dialog
/ME.EVENT.TIME ........: To open Event > Time dialog
/ME.EVENT.WIN .........: To open Event > Window dialog
/ME.EVENT.OTHER .......: To open Event > Other dialog
------------------------
"Event" functions have there own description.

Example: {/ME.EVENT.KEYS}


/ME.EVENT.TIME.OFF ....: To switch Time Event function generally off
/ME.EVENT.WIN.OFF .....: To switch Window Event function generally off
------------------------
This command can de-activate "Event" functions without open the "Event"
user interfaces.

Example: {/ME.EVENT.TIME.OFF}


/ME.FKEYS .............: To open F-Keys dialog
/ME.FKEYS.RELOAD ......: To reload F-Key assignments
/ME.FKEYS.SURVEY ......: To view F-Keys survey
/ME.FKEYS.TEMP-OFF ....: To switch F-Key assignments temporary on/off
------------------------
The F-Keys assignment is valid only if RK has the focus.

Example: {/ME.FKEYS}
Example: {/ME.FKEYS.RELOAD}
Example: {/ME.FKEYS.SURVEY}
Example: {/ME.FKEYS.TEMP-OFF}

The TEMP-OFF command is a switch.
Call it again to swap the state from on > off > on...
The state will not be saved on disk. Everytime RK starts the state is "on".


/ME.FONT.SLCT .........: To select a font for RemoteKeys panel
/ME.FONT.NORMAL .......: To switch RemoteKeys to the default font
------------------------
Der Zeichensatz, mit dem die RK-Knpfe beschriftet werden, kann global gendert
werden.
Wenn in den Profil-Einstellungen unter Schriftgre "Vorg." (= Vorgabe) ein-
getragen ist, so ist die dortige Einstellung abhngig von dem global einge-
stellten Schriftgrad.

Example: {/ME.FONT.SLCT}


/ME.HIDE ..............: To hide RemoteKeys
------------------------
Dieser Command bewirkt das selbe, als wenn auf das Schlie-Symbol des RK-
Fensters geklickt wird, sofern in den Einstellungen
"Schliesymbol > RK verbergen" aktiviert ist. Wenn sich RK im Systray
verbirgt, kann man es durch einen Klick auf das Systray-Icon wieder
auf den Bildschirm zurckholen.
Interessant knnte dieser Command sein, wenn man nach Ausfhrung einer
Automation RK vom Bildschirm verschwinden lassen mchte, indem man
diesen Command an das Ende des Skriptes setzt.

Example: {/ME.HIDE}


/ME.IMAGE.MEMORY ......: To open the external program "ImageMemory"
------------------------
This program has its own description
and can also be opened by selecting from pop and systray menu.

Example: {/ME.IMAGE.MEMORY}


/ME.KEYS.EDIT .........: To open the Keys Edit dialog
------------------------
Der vollstndigkeitshalber gibt es natrlich auch einen Command um das gar
so wichtige "Bearbeiten > Knpfe"-Fenster zu ffnen, es sei aber empfohlen,
das Fenster mit einem Mausklick auf den linken Mausknopf auf einen der RK-
Knpfe, bei gleichzeitig gedrckter [Strg]-Taste zu ffnen.

Example: {/ME.KEYS.EDIT}


/ME.MANUAL ............: To open the Manual.exe application
------------------------
ffnet das im Hauptordner von RK bedindliche Manual.exe-Programm, mit dem
Du Dir vermutlich just in diesem Moment diesen Text durchliest.

Example: {/ME.MANUAL}

-> Beachte
Ab v7.4.31 schaltet sich das Programm automatisch auf die aktuell eingestellte
Sprache.


/ME.MEMOPAD ...........: To open the external MemoPad
------------------------

Example: {/ME.MEMOPAD}

--> Caution
MemoPad uses the profile and button numbers to identify the different file names.
Therefore profile order changes will be corrected and button moves will be stoped.


/ME.MENU.SWITCH .......: To switch the pull-down menu on/off
------------------------
Wer aus Gewohnheitsgrnden eine Men-Leiste im RK-Fenster haben mchte,
kann diese mit diesem Command ein- bzw. ausschalten.
Alle dort befindlichen Men-Punkte lassen sich aber ber das Systray-
Pop-Men sowie diesen ME-Commands aufrufen.

Example: {/ME.MENU.SWITCH}


/ME.MINIMIZE ..........: To minimize the RemoteKeys window
------------------------
Minimiert das RK-Fenster in gleicher Weise, als wenn der Windows-Minimier-
Knopf des Fensters in der rechten, oberen Ecke angeklickt wird.

Example: {/ME.MINIMIZE}


/ME.MOUSEHIDE .........: To open Hide on Mouse Position dialog
------------------------
Die "Bei Maus-Position Verbergen"-Funktion besitzt einen eigenen Beschreibungs-
text der in dieser Anleitung mit "RK durch Mausklick ffnen" betitelt ist.

Example: {/ME.MOUSEHIDE}


/ME.POP.ALL ...........: To view systray popmenu, complete
/ME.POP.CD ............: To view CD control popmenu
/ME.POP.LANGUAGE ......: To select language of RK
/ME.POP.OPTION ........: To view systray popmenu, profiles and edit dialogs
/ME.POP.PROF ..........: To view systray popmenu, profiles only
/ME.POP.REQUEST .......: To view systray popmenu, all dialogs only
/ME.POP.STATE .........: To view systray popmenu, state commands like hide.. only
------------------------
Mit den POP-Commands, die alle etwas unterschiedliche RK-Funktionen zusammen-
fassen, lt sich komfortabel durch die Men-Struktur von RK navigieren.
Es sei an dieser Stelle nur an das OPTION-Men verwiesen, das in jedem Profil
in Gestalt des "Opt"-Knopf vorbelegt ist.
Viele weitere Beispiele finden sich im "Manual"-Profil in der obersten
Knopfreihe.
Das "ALL"-Men entspricht z.B. dem des Systray-Popmens.

Example: {/ME.POP.ALL}


/ME.POP.USERAPP .......: To view User-Application popmenu
------------------------
Das USERAPP-Popmen ist ein selbstbelegbares Men um Anwendungen zu starten,
deren Eintrge sich in der im Profiles-Ordner befindlichen UserApp.dat-Datei
definieren lassen. Ein mit diesem Command vorbelegter Knopf befindet sich
im "Manual"-Profile im UserApp-Knopf.

Example: {/ME.POP.USERAPP}


/ME.PREFS .............: To open Preferences dialog
------------------------

Example: {/ME.PREFS}


/ME.PROF.BACK .........: To switch to the last selected profile
------------------------
Dieser Command kann ntzlich sein, mchte man zum vorher angezeigten
Profil zurckkehren, ohne sich um Nummern und Namen scheren zu wollen.

Example: {/ME.PROF.BACK}


/ME.PROF.INC ..........: To open the next profile
/ME.PROF.DEC ..........: To open the previous profile
------------------------
Mit diesen Commands kann man auf das folgende bzw. vorhergehende Profil schalten,
wobei sich die Profil-Schaltung nach den Profil-Nummern richtet (1-10).
Z.B. mit dem INC-Command von Profil-Nummer 3 auf Nummer 4. u.s.w.

Example: {/ME.PROF.INC}


/ME.PROF.EDIT .........: To open Profile Edit dialog
------------------------
Die "Profil bearbeiten"-Funktion besitzt einen eigenen Beschreibungstext.
Bevorzugt wird man dieses Fenster aber sicher aus den Popmens der "Opt"-Knpfe
ffnen.

Example: {/ME.PROF.EDIT}


/ME.PROF.EXPLORER [p] .: To open the Profile Explorer, optional: switch to profile number <p>
------------------------

Example: {/ME.PROF.EXPLORER}
Example: {/ME.PROF.EXPLORER 5}


/ME.PROFSET.RELOAD ....: To reload the Profiles.dat
------------------------

Example: {/ME.PROFSET.RELOAD}

User-Example:

{/BTCH.EXPLICIT}
{/DSK.RENAME profiles\profiles.dat,profiles9.dat}
{/DSK.RENAME profiles\profiles1.dat,Profiles.dat}
{/DSK.RENAME profiles\profiles9.dat,profiles1.dat}
{/ME.PROFSET.RELOAD}

This example swaps between 2 profiles.

--> Caution !
There is no check if everything works okay. If the script will not finish,
it could happen, that one script will be overwritten by another one.
Therefore it is recommend to make a backup of the profiles.dat before
trying this sample.


/ME.PROF.SWITCH no ....: To open a fixed profile number (<no> = 1-10)
------------------------
This command allowes to switch to a profile by its profile number (1-10)

Example: {/ME.PROF.SWITCH 5}


/ME.PROF.TMP.COL [v] ..: To change column quantity temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.ROW [v] ..: To change row quantity temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.HIGH [v] .: To change button height temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.WIDE [v] .: To change button width temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.RESET.ALL : To reset temporary changes to saved settings, all profiles
/ME.PROF.TMP.RESET.PROF: To reset temporary changes to saved settings, current profile only
------------------------
Mit diesen Commands knnen die Dimensionen von Profilen temporr gendert werden, d.h.
die nderungen werden nicht gespeichert und entsprechen sptestens nach dem nchsten Programm-Start
von RK wieder dem, was im Bearbeiten > Profil Dialog eingestellt wurde.
Da durch Weglassen des Parameters <v> die Variable VAR einspringt, knnen nderungen auch
"schrittweise" vorgenommen werden.

Example:

Knopf, Ebene 1 (linke Maus-Taste):

{/BTCH.EXPLICIT}
{/VAR.<.PROF 0}    ' VAR auf die aktuelle Spalten-Anzahl setzen (Parameter=0)
{/VAR.ADD 1}       ' VAR um eins erhhen
{/ME.PROF.TMP.COL} ' temp. Spalten-Anzahl auf VAR setzen

Knopf, Ebene 2 (rechte Maus-Taste):

{/BTCH.EXPLICIT}
{/VAR.<.PROF 0}
{/VAR.SUB 1}
{/ME.PROF.TMP.COL}

Bei jedem Klick auf diesen Knopf mit der linken Maus-Taste erhht sich die Spalten-Anzahl um jeweils
eine Spalte, bis der Maximal-Wert von 25 Spalten erreicht ist.
Entsprechend vermindert ein Klick mit der rechten Maus-Taste die Spalten-Anzahl um 1.

-> Tip
Der ME.PROF.RESET.PROF Command kann auch dazu verwendet werden, wenn das RK-Fenster nach einer
Verschiebung wieder auf seine ursprnglich gespeicherten Koordinaten positioniert werden soll.
ME.PROF.TMP.RESET.ALL lscht hingegen alle vorbergehend gespeicherten Koordinaten-Zeiger.

-> Achtung
Der Modus zur rahmenlosen Darstellung des RK-Fensters (Borderless) wird durch diese Commands
(noch) nicht untersttzt!


/ME.PROF2.INC .........: To open the previous profile without changing the window position
/ME.PROF2.DEC .........: To open the next profile without changing the window position
------------------------
Mit diesen Commands kann man eine "2. Funktionsebene" der RK-Knpfe simulieren,
wie man sie z.B. von funktionsreichen Rechnern oder Handys her kennt und die
dort gemeinhin als 2nd-Function-Tasten bezeichnet werden.

Da es diese 2. Funktionsebene in Wirklichkeit garnicht gibt, bedient man sich
einfach eines anderen Profils, das exakt die selben Fenster-Dimensionen
aufweisen sollte; also auch die Anzahl der Knopf-Spalten und Zeilen.
Ferner mu das Profil der 2. Funktionsebene um eine Nummer hher oder
niedriger liegen als das der 1. Ebene.

Der PROF2.INC-Command schaltet nun nicht nur auf das nchst hhere Profil, so
wie es der normale PROF.INC-Command macht, sondern sorgt zustzlich dafr,
da sich die Bildschirm-Position des RK-Fensters nicht ndert.

Und der 2. Effekt dieser Funktion: Nachdem ein Knopf der 2. Funktionsebene an-
geklickt wurde, schaltet RK automatisch auf die 1. Ebene zurck.

Das Profil der 2. Funktionsebene sollte einen Knopf aufweisen, der mit dem
"PROF.BACK"-Command belegt ist, damit man bei irrtmlicher Anwahl der 2. Ebene
bequem wieder zur 1. Ebene zurckkehren kann.

Example: {/ME.PROF2.INC}


/ME.PROFCENTER ........: To open Profile Center dialog
------------------------
The "Profile-Center" has its own description.

Example: {/ME.PROFCENTER}


/ME.PROFSET.SWAP ......: To swap between profile set 1 & 2
------------------------
Dieser Command hat die selbe Wirkung, als wenn im Systray-Popmenu der oberste
Punkt "Swap Profile-Set" angewhlt wird.
Nhere Erluterungen siehe auch "Profile-Set #2.txt".

Example: {/ME.PROFSET.SWAP}


/ME.PW.ENTER ..........: To enter the crypt password
/ME.PW.PROTECT ........: To protect the crypt password
------------------------
Auf die Pawort-Funktion wird im Beschreibungstext "Knpfe bearbeiten" im
Abschnitt "Verschlsselt" nher eingegangen.
Normalerweise fordert RK das Pawort vom Anwender an, wenn es einen
pawort-kodierten Knopf ausfhren soll und merkt sich dieses fr die Dauer
der Session um lstige Neueingaben zu vermeiden.
Mit dem PW.ENTER-Command kann man RK nun auch ohne Ausfhrung eines kodierten
Knopfes das Pawort (zum Merken) mitteilen.
Mit dem "PW.PROTECT"-Command veranlat man RK sozusagen dazu, da Pawort
wieder zu vergessen, was eine Neueingabe beim Klick auf einen kodierten Knopf
zur Folge htte.
Beide Funktionen kann man auch aus dem Systray-Popmen mit dem Men-Punkt
"Crypt-Pawort" sperren auslsen. Hier wird je nach augenblicklichem
Zustand das Pawort entweder freigegeben oder gesperrt.


/ME.QUIT ..............: To exit RemoteKeys
------------------------

Example: {/ME.QUIT}


/ME.README ............: To open the readme file
------------------------

Example: {/ME.README}


/ME.RKNET .............: To open RK-network program
------------------------
The "RKNet" program has its own description.

Example: {/ME.RKNET}


/ME.SHOW [x,y] ........: To open (or move) RK window, optional on screen coordinates <x,y> or <,>=VAR1/2
------------------------
Dieser Command ist im Zusammenwirken der "Ereignis > Tasten"-Funktion (Hotkeys)
sinnvoll, um das RK-Fenster per Tastendruck aus dem Systray auf den Bildschirm
zu befrdern.

Example: {/ME.SHOW}

Ab v8.4.5 kann das RK-Fenster auch an vorher bestimmter Position geffnet werden.

Example: {/ME.SHOW 500,1500}

Ferner ist eine Positionierung ber die RK-Variablen VAR 1+2 mglich.
Hierfr lt man die x/y Parameter weg, soda nur noch das Komma brig bleibt.

Example:

{/BTCH.EXPLICIT}
{/VAR.FLD.CHANGE 1}
{/VAR.SET 6000}
{/VAR.FLD.CHANGE 2}
{/VAR.SET 1000}
{/ME.SHOW ,}

--> Tip
Mit Hilfe des Commands VAR.<.MOUSE.SF lt sich das RK-Fenster an Mouse-Pos. ffnen.

Beispiel:

{/BTCH.EXPLICIT}
{/VAR.<.MOUSE.SF}
{/ME.SHOW ,}


/ME.SINGLESTEP ........: To switch Edit>Keys function "Single-Step" on
------------------------
The Single-Step function is described in chapter "Edit > Keys".
A Single-Step form will open which offers a button to switch the Single-Step
mode off.


/ME.SURVEY ............:
------------------------
This function was replaced by the Profile Explorer since v7.3.
ME.SURVEY has the same effect as ME.PROF.EXPLORER.


/ME.TASKBAR.SWITCH ....: To switch taskbar button temporary between visible/unvisible
------------------------
In Preferences dialog, "Show RK in Taskbar" can permanently switched on/off.
But the TASKBAR command can switch the state temporary only, without saving
on disk.


/ME.TEXTVIEWER-OPT n ..: To change int. text viewer setting: <n>=1:maximize, 2:white bg, 3:no close but, 4:10"
------------------------
Hiermit kann das Ausgabe-Fenster z.B. des Commands {/CLIP.TXT.VIEW} beeinflut werden:
Die Einstellung mu natrlich vor dem Aufruf des Betrachters vorgenommen werden und
bleibt fr die Dauer der RK-Session bestehen, sofern sie nicht erneut gendert wird.

Parameter:

n=0: Alle Einstellungen werden gelscht
n=1: Das Fenster wird maximiert geffnet
n=2: Die Hintergrund-Farbe des Textfensters ist wei (statt grau)
n=3: Kein "Close"-Knopf im Textfenster (Alternativ Windows Schlie-Knopf [x])
n=4: 10" Schriftgre anstatt 12"


/ME.TOUR ..............: To open the external RK-Tour program
------------------------
Opens the Tour program which is placed in the RK mainfolder.

Example: {/ME.TOUR}
